home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 48 / Amiga Format CD48 (1999-12-13)(Future Publishing)(GB)(Track 1 of 2)[!][issue 2000-01].iso / -in_the_mag- / networking / crosspc / spooler / spooler.doc < prev    next >
Text File  |  1999-11-08  |  5KB  |  175 lines
  1.             Spooler V1.0 Written by Jeff Crystal © 1998
  2.  
  3.  
  4.  
  5.     1. Introduction (or What the heck is it?)
  6.  
  7.     Spooler is a simple utility that watches a directory for new files and
  8.  
  9. then sends them to a network printer via Samba, the Unix file and printer
  10.  
  11. sharering protocol.  Samba clients exist for many operating systems, such
  12.  
  13. as Netware, OS/2, Windows for Workgroups, WindowsNT and Windows 95/98.
  14.  
  15. The Windows 95/98 client is otherwise know as Client for Microsoft Networks.
  16.  
  17. Spooler allow you to print to a printer connected to a Windows 95 machine
  18.  
  19. anywhere on the internet or your local network, for example.
  20.  
  21.  
  22.     2. Requirements
  23.  
  24.     First and foremost, you must have installed Samba, as well as AmiTCP
  25.  
  26. (or any other AmiTCP compatible TCP/IP stack, such as Miami.) You must have
  27.  
  28. a working network connection between your amiga and the server machine that
  29.  
  30. is sharing the printer you want to connect to.  I recomend using an ethernet
  31.  
  32. connection for speed reasons, but a modem connect will work fine to.  You also
  33.  
  34. must have smbclient (comes with samba) installed somewhere in your path.
  35.  
  36.  
  37.  
  38.     3. How does it work?
  39.  
  40.     Spooler relies on the standard utility CMD to capture your printer's
  41.  
  42. output to a file.  Spooler runs in the background and once about every 10
  43.  
  44. seconds or so will examine the spool directory for files.  As it encounters
  45.  
  46. a file, if it can get an exclusive lock on the file (i.e. CMD is not still
  47.  
  48. writing to it,) it will call smbclient to ship the file off to the remote
  49.  
  50. printer, then delete the file.  Once it finishes all files in the directory
  51.  
  52. it waits another 10 seconds and starts over.  Spooler does not currently have
  53.  
  54. any way to quit running.  If you'd like to have a quit command for it, send
  55.  
  56. me an email and I may include that in a future version with enough demand.
  57.  
  58.  
  59.  
  60.     4. Installation
  61.  
  62.     First add the following line to your s:user-startup file:
  63.  
  64.     Assign SpoolDir: Work:SpoolFiles ; Replace with any path you like
  65.  
  66. Next, move or copy CMD from your Tools directory to your WBStartup directory,
  67.  
  68. and edit it's tooltypes.  The following values are what I use:
  69.  
  70.  
  71.     DEVICE=parallel
  72.     FILE=SpoolDir:PrintFile
  73.     SKIP=FALSE
  74.     MULTIPLE=TRUE
  75.     NOTIFY=FALSE
  76.  
  77. if you have a printer attached to your parallel port already, you could use
  78.  
  79. DEVICE=serial instead for the network printer.  Next, copy spooler and smbclient
  80.  
  81. (from the samba/bin directory) into your C: directory.  (Spooler explicitly
  82.  
  83. looks for these files in C:)
  84.  
  85.     Now each time you print, the output will be captured to a file in your
  86.  
  87. spool directory.  To send it to the remote printer automatically, add the
  88.  
  89. following line to the end of your amitcp:db/user-startnet file:
  90.  
  91.     run <nil: >nil: spooler <printer_path> [SpoolDir]
  92.  
  93. replace <printer_path> with the machine name and printer name you want to
  94.  
  95. print to, for example, to print to a printer named HP6L on a windows 95
  96.  
  97. machine named Keith, printer_path would be \\keith\hp6l.  (Note that path names
  98.  
  99. are not case sensitive.) If you assigned SpoolDir: as instructed above,
  100.  
  101. [SpoolDir] is not needed.  If you'd like to use something other that SpoolDir:
  102.  
  103. then file in [SpoolDir] with any path you would like.  It *MUST* end in
  104.  
  105. either : or / for spooler to work! Spooler only runs from the CLI.
  106.  
  107.     Spooler also accepts the debuging command -d as a parameter.  If included,
  108.  
  109. Spooler outputs to the file RAM:Spooler.out debug information.
  110.  
  111.  
  112.  
  113.     5. Notes
  114.  
  115.     Don't forget that you must pick a printer driver from prefs that is
  116.  
  117. compatible with the printer you want to use.  Spooler is simply redirecting
  118.  
  119. the raw output of your printer.device over the network.
  120.  
  121.     spooler and smbclient (from the samba/bin directory) MUST be copied to
  122.  
  123. your C: directory.
  124.  
  125.     I have successfully tested this program with Samba v1.9.16p9 and an HP
  126.  
  127. Laserjet printer shared by a Windows 95 machine.
  128.  
  129.     Spooler is Freeware, so use and enjoy. But remember that you get what
  130.  
  131. you pay for!  The author makes no claims that this software will work on
  132.  
  133. any system but his own.  Use this software at your own risk.  This software
  134.  
  135. carries No Warranty of any kind, Express or Implied.
  136.  
  137.  
  138.  
  139.     6. Troubleshooting
  140.  
  141.     Be sure that smbclient is in C:.
  142.  
  143.     RAM: must be accessable if you intend to use the debugging feature (-d)
  144.  
  145.     Make sure that you can ping the server machine.
  146.  
  147.     Try listing shared services with smbclient (i.e. smbclient -L <machine_name>)
  148.  
  149. if you can list the services, you should be able to use them.
  150.  
  151.     Make sure that the printer has no password!  Spooler does not yet support
  152.  
  153. sending passwords.
  154.  
  155.     If all else fails, read the Samba documentation (RTFM!!)
  156.  
  157.  
  158.  
  159.     6. Bugs
  160.  
  161.     None Known.  If you find one, let me know!
  162.  
  163.  
  164.  
  165.     6. Contacting the Author
  166.  
  167.     Constructive comments, Feature Requests, etc.
  168.  
  169.     Email
  170.     darkmagi@freeway.net
  171.  
  172.     Flames, Abuse, and similar please send to:
  173.  
  174.     Email
  175.     bgates@microsoft.com